OnWeight · Flow Map

Daily loop
& off-pace

The retention core and the decision logic behind it. Every morning the athlete logs a weigh-in; the app turns that into a calm verdict — and, only on confirmed evidence, an offer to change the plan. This map shows the loop, the verdict cascade that judges each reading, and the off-pace branches. The why behind the thresholds is in the Methodology Brief; this is the screen-and-decision flow.

01 The daily loop

The habit that predicts retention. Four beats, every morning, then back to Today — most days it takes ten seconds.

Morning · promptReminderPush at the set weigh-in time. Lock-screen nudge — the loop's trigger.
Tap to logLog weightNumber pad, fasted weight. One value, typed and saved.
Instant readResultConfirmation + verdict, plus a calm consistency reward for showing up (the cascade, §02).
Back to TodayDashboardTrend, projection and pace verdict refresh. Done for the day.
Repeats every morning. The rolling 7-day window recomputes each day — nobody waits for a weekly checkpoint.

02 The verdict cascade

Each reading steps through three timescales against the cycle-adjusted expected weight. Steps 1–2 are silent — they never flag the athlete. Only the 7-day rate produces the displayed verdict.

Step 1Daily gate
Within ±0.2 kg of the cycle-adjusted expected weight → silently fine. Off it → escalate quietly, no alarm.
Silent
Step 23-day filter
A wider ±0.4 kg band matched to real noise. Decides whether to bother computing the rate — a filter, not a pass/fail.
Silent
Step 37-day rate
Last-7 vs prior-7-day true-weight rate (cycle water removed). Needs ≥4 logged days per window. This is the on-track / behind / too-fast call.
The verdict

Displayed outcomes: On track   Behind / Too fast   Off the pace — red reserved for genuine risk.

03 Off-pace · early warning, then the offer

Being off-pace runs on two channels. A soft early-warning that never changes anything, and the hard triggers that actually offer a new plan.

Channel 1 · Drift-watch — soft, early, never red

A CUSUM accumulates small same-direction deviations from plan and opens a quiet “I'm watching this” note in ~2–3 days of consistent drift — days before a 7-day rate could confirm it. It never launches a plan change. Tightens its sensitivity as fight day nears. → Screens: Drift-watch · creeping behind / cutting fast

The Change-your-plan flow is offered only on a confirmed, hysteresis-protected hard trigger — never one noisy window:

Trigger A · Projection miss
Projected scale weight (trend + weigh-in-day cycle water) misses the limit, confirmed across two reads.
Protects against arriving over the limit on the day.
→ Change Plan · projection
Trigger B · Safety ceiling
Measured rate exceeds ~1%/wk of bodyweight.
Fires independently of making weight — protecting performance & health is its own goal.
→ Change Plan · safety

Both directions, opposite advice

Drifting behind → tighten intake gently. Cutting too fast → add food back. The flow only ever offers safe routes — move up a division, move the date, or hold at the capped safe rate — and nothing changes until the athlete chooses. The soft drift-watch and the hard triggers map to the matching variants in All Screens.

04 How it's wired in the prototype

In the clickable prototype, the Pace toggle (On / Behind / Off) drives these verdicts live across Dashboard, Result and the drift screens, and the logged number on the Log screen now derives its own verdict. The off-pace screens lead to the matching Change-Plan screen: behind → projection, fast → safety.

Companion to OnWeight, Logic & Flows.md (§9 tracking, §9.2 triggers), the Methodology Brief (the evidence), and the Camp Lifecycle map (this loop runs inside the Active state).

OnWeight HQ